home *** CD-ROM | disk | FTP | other *** search
/ The Programmer Disk / The Programmer Disk (Microforum).iso / xpro / c / pro14 / bm.man < prev    next >
Text File  |  1986-04-02  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4.      BBBBMMMM((((PPPPUUUUBBBBLLLLIIIICCCC))))          XXXXEEEENNNNIIIIXXXX 3333....0000 ((((22221111 JJJJuuuunnnneeee 1111999988885555))))           BBBBMMMM((((PPPPUUUUBBBBLLLLIIIICCCC))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           bm - search a file for a string
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           ppppuuuubbbblllliiiicccc bbbbmmmm [ option ] ...  [ strings ] [ file ]
  13.  
  14.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.           _B_m searches the input _f_i_l_e_s (standard input default) for
  16.           lines matching a string.  Normally, each line found is
  17.           copied to the standard output.  It is blindingly fast.  _B_m
  18.           strings are fixed sequences of characters: there are no
  19.           wildcards, repetitions, or other features of regular
  20.           expressions.  Bm is also case sensitive.  The following
  21.           options are recognized.
  22.  
  23.           ----xxxx   (Exact) only lines matched in their entirety are
  24.                printed
  25.  
  26.           ----llll   The names of files with matching lines are listed
  27.                (once) separated by newlines.
  28.  
  29.           ----cccc   Only a count of the number of matches is printed
  30.  
  31.           ----nnnn   Each line is preceded by the number of characters from
  32.                the beginning of the file to the match.
  33.  
  34.           ----ssss   Silent mode.  Nothing is printed (except error
  35.                messages).  This is useful for checking the error
  36.                status.
  37.  
  38.           ----ffff _f_i_l_e
  39.                The string list is taken from the _f_i_l_e.
  40.  
  41.           In all cases the file name is shown if there is more than
  42.           one input file.  Care should be taken when using the
  43.           characters $ * [ ^ | ( ) and \ in the _s_t_r_i_n_g_s (listed on the
  44.           command line) as they are also meaningful to the Shell.  It
  45.           is safest to enclose the entire _e_x_p_r_e_s_s_i_o_n argument in
  46.           single quotes ' '.
  47.  
  48.           _B_m searches for lines that contain one of the (newline-
  49.           separated) _s_t_r_i_n_g_s, using the Boyer-Moore algorithm.  It is
  50.           far superior in terms of speed to the grep (egrep, fgrep)
  51.           family of pattern matchers for fixed-pattern searching, and
  52.           its speed increases with pattern length.
  53.  
  54.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  55.           grep(1)
  56.  
  57.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  58.           Exit status is 0 if any matches are found, 1 if none, 2 for
  59.           syntax errors or inaccessible files.
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 3/18/86)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      BBBBMMMM((((PPPPUUUUBBBBLLLLIIIICCCC))))          XXXXEEEENNNNIIIIXXXX 3333....0000 ((((22221111 JJJJuuuunnnneeee 1111999988885555))))           BBBBMMMM((((PPPPUUUUBBBBLLLLIIIICCCC))))
  71.  
  72.  
  73.  
  74.      AAAAUUUUTTTTHHHHOOOORRRR
  75.           Peter Bain (pdbain@wateng)
  76.  
  77.      BBBBUUUUGGGGSSSS
  78.           Only 100 patterns are allowed.
  79.  
  80.           Patterns may not contain newlines.
  81.  
  82.           If a line (delimited by newlines, and the beginning and end
  83.           of the file) is longer than 8000 charcters (e.g. in a core
  84.           dump), it will not be completely printed.
  85.  
  86.           Successive matches of different patterns may appear out of
  87.           order.
  88.  
  89.           A line will be printed once for each different string on
  90.           that line.
  91.  
  92.           The algorithm cannot count lines.
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 3/18/86)
  130.  
  131.  
  132.  
  133.